FM Towns: Free Software Collection 4/FM Towns Free Software Collection 4 - Disc 1.iso/msdos/tkshl/tkcl2.doc

Text File | 1991-10-18 | 17KB | 406 lines

*****************************************************************************
　　　　　　　　　　ＴＫＣＬ(TK-team Command Language)

　　　　　　　　　　　文法仕様書・Ver 2.0   1990-08-08

                                    (C) 1990 TK-team amusement ware

　　　※この仕様書はＴＫＳＨＬ．ＥＸＥ(Ver 2.0)に対応しています

　　ＴＫＣＬに対するご質問・ご要望につきましては、以下にご連絡ください

     連絡先:ＴＫチーム
　　　　　　　　　　　　ハンドル　　 NIF-ID     MAD_i-ID
　　　　　　　　　　------------------------------------
      FM移植担当     ＷＩＴＮＥＳＳ  QFG01032     ---
  　　　　　　　　　------------------------------------
      ｵﾘｼﾞﾅﾙ作成     としくん　　    NBB00261   MAD_0238
　　　　　　　　　　 Ｑたらう　　    MHA00175　 MAD_0246
   　　　　　　　　  ＤＡＮＤＹ　    NAH00602   MAD_0247
　　　　　　　　　　------------------------------------

*****************************************************************************

１．　初めに

　　ＴＫＣＬは、Command  Interpreter であるＴＫＳＨＬ．ＥＸＥによって実行さ
  れる、ゲ－ム用言語である。記述されたテキストファイルはＴＫＳＨＬ．ＥＸＥ
　により順次実行されていく。また、複数のテキストファイルで１つのゲ－ムを構成
　することも可能である。ＴＫＣＬは画像デ－タの制御機能も持つが、画像デ－タは
　別ファイルとして持たなければならない。音楽デ－タの制御については現在の所
　未サポ－トである

２．　スクリ－ンの分割

　　ＴＫＣＬでは半角で８０文字×２５行のスクリ－ンを対象とする
　(0,0)
   -------------------------------------------------------------
   |*(2,1)*************************************                |
   |*                                         *                |
   |*                                         *                |
   |*  メイン画像領域                         * *(59,6)******* |
   |*                                         * *            * |
   |*                                         * *            * |
   |*                                         * * ﾏｽｺｯﾄ 領域 * |
   |*                                         * *            * |
   |*                                         * *            * |
   |***********************************(57,18)* ******(77,18)* |
   |+--------------------------------------------------------+ |
   ||                                                        | |
   || メッセージエリア（ユーザーは気にしなくて良い）         | |
   |+--------------------------------------------------------+ |
   -------------------------------------------------------------(79,24)

　２．１　画像領域

　　　グラフィック画像を表示するための領域である。この領域はＴＫＣＬで直接
　　制御することが出来ない。ＴＫＣＬによって呼び出される画像ファイルは基本
　　的には領域を気にしなくともよい。ただし、シナリオメッセージ表示部分との
　　関係で、重なってしまうと見にくくなってしまうので、考慮する事。
　　画像のセーブ／ロードには、専用のTKSV.EXE・TKLD.EXE（未公開）がある。

　　※基本画像領域（だんでぃだんでぃの例）
　　前述の座標(1,1)-(56,18) を基本画像領域と設定してある。
　　データのサイズは 64566バイトになる。（パレット、その他のデータを含む）

　２．２　シナリオ領域

　　　シナリオメッセ－ジ、及び設問メッセ－ジを表示するための領域である。メ
　　ッセ－ジは常に最上行から一連の単位で表示されていき、キ－ボ－ドからの応
　　答を待つ。キ－ボ－ドから正しい応答があると、メッセ－ジは消去され次のメ
　　ッセ－ジ表示に移る。
　　ゲーム制作においてユーザーが気を付けるところは、
　　　　　・１メッセージを５行以内にする事
　　これだけである。（注・選択肢の表示方法も同様に５行以内にする事）

　２．３　マスコット領域

　　　マスコットを表示するための領域である。現得点、及び、解答の正否に色を
　　付けるための泣き笑いや何かマスコットを表示したい場合はここを使う。
　　前述の画面中(58,6)-(76,18) がこれにあたる。
　　マスコット領域だけは固定であり、ユーザーは変更できない。
　　表示のオン／オフはＴＫＣＬ文法で可能である。
　　データのサイズは 15862バイトになる。（パレット、その他のデータ含む）
　　データは TKSV.EXEで作られたデータファイルがそのまま使用できる

３．　文

　　ＴＫＣＬテキストファイルは文によって構成される。文には、コマンド文とメッ
　セ－ジ文、及び、コメント文がある。
　　コマンド文は１つのコマンドを持っている文であり、半角文字により構成されて
　いなければならない。１つのコマンド文には１つのコマンドしか記述できない。１
　つの文に複数のコマンドを記述した場合、２つ目以降のコマンドは無視される
　　メッセ－ジ文は直前のコマンド文によって宣言され、スクリ－ンのシナリオ領域、
　または設問領域に表示されるべきデ－タを持っている。
 　　コメント文には明示的宣言はなく、ＴＫＳＨＬにより自動認識される。すなわち
　１つのコマンドもなく、コマンド文によるメッセ－ジ宣言もない文がこれに該当する。
　　文と文とは区切り記号により、識別される。区切り記号には、CR , LF , CR+LF
　および、 ; (ｾﾐｺﾛﾝ) がある。 CR+LF　は１つの区切り記号として扱う。

４．コマンド仕様

　　コマンドには次の種類がある。

　　1). MES     : 次文から１連のメッセ－ジ文があることを宣言する。
    2). MEND　　: １連のメッセ－ジ文の終了を宣言する。
    3). SELECT  : 選択肢の表示と解析を行うための SELECT ブロックの宣言を行う。
    4). CASE    : キ－ボ－ド入力コ－ドの判定のためのコマンドである。
　　5). RETRY　 : SELECTブロックの先頭に戻る。
    6). SEND　　: SELECTブロックの終了を宣言する。
    7). JUMP　　: 指定したラベルの処理を分岐させる。
    8). IF　　　: POINT または　FLAGの状態により処理を分岐させる。
    9). POINT　 : 得点 (POINT) を増減させる。
 ※10). FLAG  　: FLAGの設定を行う。
 ※11). PICTURE : 画像の表示を行う。
 ※12). CLEAR   : 画面の（全面）クリアを行う。
   13). CHAIN   : 現在のテキストファイルを終了させて他のテキストファイルで
　　　　　　　　　処理を行う。
   14). EXIT　　: ゲ－ムを終了させる。
 ☆15). MASCOT  : マスコットファイルの指定や、表示のオン／オフを行なう。
 ☆16). GCOPY   : 裏ＶＲＡＭから表ＶＲＡＭへ領域志向のコピーを行なう。
 ☆17). PAUSE   : 動作を一時中断させる

　※は Ver2.0 で機能拡張したコマンドである。
　☆は Ver2.0 から追加されたコマンドである。

　４．１　MES コマンド

  　次の文から、一連のメッセ－ジ文があることを宣言する。メッセ－ジ文はMEND
   コマンド文が出現するまで連続する。メッセ－ジ文は、半角の';'コ－ド，CRコ
   －ド、または MENDコマンドが現れるまで連続してスクリ－ンのメッセ－ジ領域
　 に表示され、キ－ボ－ドのリタ－ンキ－応答を待ってから次の文に進む。

　　　Ex.
            MES
            「ふ－－－む、なかなかいいお尻してるなあ」　｜　この２行は連続
　　　　　　「え？　なにか言った？」<CR>　　　　　　　　｜　して表示される。
　　　　　　「いや、なんにも・・」；
　　　　　　MEND

　４．２　MENDコマンド

　　　一連のメッセ－ジ文の終了を宣言する。このコマンドは、MES文、または、
　　SELECT文と組み合わせて使用する。

　４．３　SELECT コマンド

　　　選択肢による設問と、その応答を処理するための SELECT ブロックの開始宣言
　　である。１つの SELECT ブロックは SEND 文により終了する。１つの SELECT ブ
　　ロックには、２つ以上の設問メッセ－ジ文、及び２つ以上の CASE コマンド文
　　を含んでいなければならない。
      SELECTコマンドは、次文から一連の設問メッセ－ジ文があることも宣言する。
　　メッセ－ジ文は MEND コマンドが出現するまで連続し、スクリ－ンの設問領域に
　　表示される。表示領域の制限により設問メッセ－ジは５行以内とする。全部のメ
　　ッセ－ジを表示後、キ－ボ－ド応答待ちとなり、入力コ－ドに対する処理は、
　　CASE コマンド文により決定される。

　　Ex.

        SELECT
          １．いいわけをする
　　　    ２．おならをする
　  　　　３．いきなりナニをナニする
          ４．笑ってごまかす
　　　　　MEND
          CASE 1
            MES
            ｢は－－い、さいなら～」
　　　　　　MEND;   EXIT;         　死に～
          CASE 2
            POINT +20;  RETRY;  　　 プラス　２０点　でもう一度
          CASE 3
            MES; 「ナニをナニすんのよおっ！」
　　　　　　MEND
            POINT -30    　　　　　　マイナス ３０点　で  ABC　に分岐
            JUMP ABC
          CASE 4
            MES
            「しゅわっち！！」
　　　　　　MEND
            POINT +50  　   　　　　 プラス　５０点で次に進む
　       SEND

　４．４　CASE コマンド

       CASE コマンドは、SELECTブロックの中でのみ有効である。CASE コマンドは
　　　デ－タを伴っており、その書式は、

　　　　　CASE c 　　  である。　ｃは、１つの半角文字である。

　　　CASEコマンドで指定された文字コ－ドとキ－ボ－ド入力文字コ－ドが一致する
　　 と、連続する　CASE ブロックを実行する。 CASE　ブロックは、次に CASE コ
     マンド　または、SEND　コマンドが出現するまで有効である。 CASEブロックの
　　 中では、SELECT, CASE, SEND　を除く全てのコマンドが記述可能である。

　　　なお、設問メッセ－ジで表示する項目番号と CASEコマンドで指定するコ－ド
　　とは文法的には無関係である。普通の神経を持った作製者ならば一致するはずで
　　あるけど・・・

　４．５　RETRY コマンド

　　　RETRYコマンドは、SELECTブロックの中でのみ有効であり、SELECTブロックの
　　冒頭のキ－ボ－ド入力待ちの状態に戻る。

  ４．６　SEND　コマンド

      SENDコマンドはいわゆるひとつの SELECTブロックの終了を宣言する。

　４．７　JUMP コマンド

　　　JUMPコマンドは、デ－タを伴っており、その書式は、

　　　　JUMP  ラベル名　　　である。

　　　ラベル名は 半角文字で８文字、全角で４文字までとする。定義されたラベルは
　　同一のテキストファイル中に定義されていなければならない。
　　　ラベルを定義する場合、文の先頭から'#'に続けてラベル名を記述する。ラベル
　　の定義はコマンド文でもコメント文でも可能である。ただ、メッセ－ジ文には定義
　　してはならない。また、ラベル名はコマンドとして定義されている半角の文字列を
　　含んでいてはならない。従って、ラベル名には全角か数字を使用することが望まし
　　い。
      JUMP先のラベルは他の SELECTブロックの中に定義することも可能である。しか
    し、その場合、RETRYコマンドが出現しても無視される。

　　　Ex.
           ........
           ........
           JUMP A1110
           .......
           .........
          #A1110  MES
            ｢ジャンプ先だよ－－ん」
   　　　　MEND

　４．８　IF コマンド

　    IF コマンドはデ－タを伴っており、その書式は、

　　　 IF  POINT  =  nn  GOTO  ラベル名
　　　　　 FLAGn  <
                  >

     である。nnは４桁以内の１０進数、ラベル名は JUMP コマンドと同仕様である。
     FLAGn は FLAG0 ～ FLAG9 の範囲で指定する。
　　  =, < , > の条件式が真であるならば、ラベル名で指定されたラベルに処理を
　　分岐させ、条件式は偽ならば、次のコマンドを実行する。

　４．９　POINT　コマンド

　　　POINT コマンドは、デ－タを伴っており、その書式は、

　　　　POINT +nn
              -nn

    である。 nn は４桁以内の１０進数である。得点(POINT)を増減させるのに使用
　　する。 POINT の初期値は　０である。
    POINTコマンドによりPOINT値の変動があった場合には、自動的にマスコット画像
    表示を行う。マスコット画像デ－タは３種類有り、得点の増減にマッチした画像
    を、テキストファイルと同じディレクトリに用意しておかなければならない。後
    述の、MASCOTコマンドを使用しない場合のファイル名は下記に示すものであり、
    起動時に、バッファに読み込まれる。ファイルが存在しない場合は読み込まれな
    い。

　　　　得点変化なしの時：　ANM1.TKG
        得点減少の時　　：　ANM2.TKG
        得点増加の時　　：　ANM3.TKG

　　マスコット画像を変更する時は、'MASCOT'コマンドを使用する。

　４．１０　FLAG コマンド

　　　FLAG コマンドはデ－タを伴っており、その書式は、

　　　　FLAGn = nn
　　　　FLAGn + nn
        FLAGn - nn

    である。 nnは４桁以内の１０進数である。FLAGn は　FLAG0 ～ FLAG9 の範囲
　　で指定する。FLAG コマンドが指示されると指定された FLAG に指定された数値
　　を代入、加算、減算する。設定した　FLAG0 ～ FLAG9 は IF コマンドで参照す
　　ることができる。なお、 FLAG0 ～ FLAG9 の初期値は全て０である。

　４．１１　 PICTURE コマンド

　　　PICTUREコマンドはデ－タを伴っており、その書式は、

　　　　PICTURE[/B] ファイル名

　　である。ファイルパス名は、画像デ－タを持ったファイルを示す。画像デ－タ
　　ファイルは、いわゆるひとつのＴＫツ－ルである、ＴＫＳＶにより作製された
　　ファイルもしくはそれに準ずるものであること。
　　　このコマンドが指示されると、指定されたファイルを読み込み、G-VRAM上に
　　展開する。PICTURE/B とした時は裏G-VRAM に展開する。裏G-VRAM に展開した
　　場合に、 GCOPYコマンドでデータを転送させることが出来る。

　４．１２　 CLEAR コマンド

　　　CLEAR コマンドは、基本画像エリア、全画面エリアの領域をクリアする機能
　　　を持ち、その書式は、

　　　CLEAR [ALL]

　　　ALLなし：基本画像エリアをクリアする。
　　　ALLあり：全領域をクリアする。

　４．１３　 CHAIN コマンド

　　　CHAIN コマンドは、デ－タを伴っており、その書式は、

　　　　 CHAIN  ファイルパス名

　　である。ファイルパスは、ＴＫＣＬテキストファイルを示す。このコマンドが
　　指示されると指定されたファイルを読み込み、その先頭を、次のコマンドとし
　　て処理を続ける。実行中のテキストファイルはクロ－ズされる。

　４．１４　EXIT コマンド

　　　ゲ－ムを終了させる。この、コマンドが実行されるとＴＫＳＨＬの実行が終
　　了し、コンソ－ルの制御は、ＭＳ－ＤＯＳに戻る。

　４．１５　MASCOT コマンド(Ver2.0)

　　　マスコット領域へ表示するファイルを指定。表示のオン／オフ機能を持つ。

　　　書式：MASCOT fn1 fn2 fn3
            MASCOT ON
            MASCOT OFF

　　　　　　　fn1：通常表示されるファイル(ﾃﾞﾌｫﾙﾄ:ANM1.TKG)
　　　　　　　fn2：ポイントが下がったときに表示されるファイル(ﾃﾞﾌｫﾙﾄ:ANM2.TKG)
　　　　　　　fn3：ポイントが上がったときに表示されるファイル(ﾃﾞﾌｫﾙﾄ:ANM3.TKG)
　　　　　　　ON ：マスコット表示をオンにする
              OFF：マスコット表示をオフにする

　　　ＴＫＳＨＬ起動時に、ANM1～ANM3.TKGが存在すると、それらをバッファに
　　　自動的に読み込む、ファイルが存在しなければ読み込まれない。その後、
　　　点数の上下により自動的にバッファよりＶＲＡＭに転送され表示される。
　　　以降、再び'MASCOT'コマンドでファイル名を指定されるまでバッファの内
　　　容は保持される。データファイルからON/OFFにより、表示／非表示の切り
　　　替えができる。ＴＫＳＨＬ起動時はMASCOT ON の状態になっている。

　　　ゲーム中、全領域を使用したグラフィックを用いる際は、表示をオフにし
　　　た方がより効果的な演出効果を狙える。

　　　（注意）'PICTURE' コマンドで画像を呼び出す際、マスコットファイルの
　　　　　　　パレットがメイン画像と異なる場合に、マスコット画像の色合い
　　　　　　　がおかしくなる。ゲームの感じがよほどおかしくなる場合には、
　　　　　　　'CLEAR ALL' で全グラフィック画面をクリアした後、
　　　　　　　'MASCOT OFF'でマスコット画像を非表示にしておいてから、
　　　　　　　'PICTURE' コマンドで画像を表示すれば汚いマスコットを見られ
　　　　　　　ずに済ます事ができる。

　４．１６　GCOPY コマンド(Ver2.0)

　　　書式　GCOPY left1 top1 right1 bottm1 left2 top2

　　　　　　left1　：コピー元（裏G-VRAM）の左座標
　　　　　　top1   ：コピー元（裏G-VRAM）の上座標
            right1 ：コピー元（裏G-VRAM）の右座標
            bottom1：コピー元（裏G-VRAM）の下座標
            left2　：コピー先（表G-VRAM）の左座標
            top2　 ：コピー先（表G-VRAM）の上座標

　　　裏G-VRAMより表G-VRAMへコピーする機能を持つ。
　　　座標はテキスト座標(0,0)-(79,24) で示す。それ以下のドット単位でのコピー
　　　はできない。数値は必ず２桁で示さなければならない。また、要注意事項とし
　　　て、コピーする領域は６４ＫＢを超えてはならない。６４ＫＢは画面半分に相
　　　当する。

　　　例）GCOPY 00 00 79 24 00 00 　←　これは全画面コピーであるが、
　　　　　　　　　　　　　　　　　　　　６４ＫＢを超えるので動作しない

　　　例）GCOPY 00 00 09 09 10 22   ←　これはデータ範囲は６４ＫＢ以下であるが
　　　　　　　　　　　　　　　　　　　　座標(10,22) から10*10 のデータの転送は
　　　　　　　　　　　　　　　　　　　　不可能であるので動作しない

      例）GCOPY 00 00 09 09 70 15   ←　これは、左上10*10 領域を、右下10*10
          　　　　　　　　　　　　　　　領域に転送する

　　　裏Ｖ－ＲＡＭから表Ｖ－ＲＡＭに転送するので、'PAUSE' コマンドで時間の調節
　　　をしつつ、裏Ｖ－ＲＡＭから次々と転送する事により、アニメーション処理が可
　　　能になる。

　４．１７　PAUSE コマンド(Ver2.0)

　　　書式　PAUSE xx

      機能　xx/100秒処理を停止する

　５．最後に

　　　　ＴＫＳＨＬもバージョン２となり、アニメーション機能を筆頭にゆっくり
　　　とではありますが進歩しております。皆様からのご意見やご感想のメールや
　　　ご要望を伺い参考になりました。どうもありがとうございました。皆様から
　　　のご要望中に多かった「セーブ機能」に関しましては保留となりました事を
　　　お許しください。
　　　　私どもはこのプログラムをゲーム用ばかりでなく他の用途にも使用できる
　　　可能性を持っていると考えています。楽しい用途を思いつかれた方や、ゲー
　　　ム用シナリオを書いてみたい方、書いている方、画像で良いネタがある方、
　　　その他ご意見をお持ちの方は是非メールをくださる様お願い申し上げます。

                                            1990-08-08
　　　　　　　　　　　　　　　　　　　　　　(C)1990 TK-team amusement ware

　　　　　　　　　　　　　　　　　　　　　　　　　作成・としくん（ＫＡＢ）
　　　　　　　　　　　　　　　　　　　　　　　　　　　　Ｑたらう